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GENERAL 


1 . 


The  interactive  TASC  Graphics  Software  Package  (TGSP), 
developed  at  TASC,  is  based  on  NCAR  Graphics  Software  (see 
Ref.  1).  The  basic  NCAR  Graphics  Software  has  been  extensively 
modified  to  allow  for  interactive  color  graphics.  Many  enhance¬ 
ments  have  also  been  made  to  meet  the  needs  of  the  Weapons 
Support  System  (WSS).  The  following  document  contains  a  gen¬ 
eral  description  of  all  of  the  modifications  and  enhancement s 
which  are  contained  in  the  TGSP. 

TGSP  is  used  extensively  in  the  applications  software 
generated  for  the  Weapon  Support  System  (Ref.  2-5). 
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2. 


TGSP  MODIFICATIONS 


Two  major  areas  of  extensions  were  made  to  the  NCAR 
Graphics  Software  in  developing  TGSP.  First,  extensions  were 
made  to  make  the  TGSP  interactive.  Second,  extensions  were 
made  to  allow  TGSP  to  use  color  graphics. 

2.1  INTERACTIVE  TGSP 

NCAR  was  designed  to  be  a  general  plot  package  for 
use  with  many  different  plotting  dev'ices.  It  is  designed  to 
accept  high  level  commands  and  generate  an  intermediate  set  of 
cormnands  called  metacode  and  to  then  use  device  specific  rou¬ 
tines  to  convert  metacode  to  device  dependent  instructions  to 
form  a  plot.  The  metacode  translator  was  originally  designed 
by  NCAR  to  run  in  a  "batch"  type  environment.  Extensive  modi¬ 
fications  and  enhancements  were  made  to  all  of  the  metacode 
translation  routines  to  make  TGSP  interactive.  As  a  result, 
the  driv'ing  routine  was  changed  from  MCTRN  to  VvT^ITEB.  The 
program  V/RITEB  was  also  modified  to  call  the  routine  MCTRN 
when  the  internal  buffer  was  full. 

2.2  TGSP  ENHANCEMENTS 

Enhancements  were  incorporated  in  the  TGSP  for  the 
ff'l  lowing  revisons; 

•  Enable  multi-color  plots 
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•  Increase  capabilities  of  the  basic  plot 
package 

•  Decrease  execution  time. 

The  next  sections  will  explain  the  high-level  portions  of  the 
modified  software. 


2.2.1  Multi-Color  Functions 

Several  subroutines  were  written  to  aid  the  user  with 
the  color  interface  to  the  TGSP.  The  following  is  a  list  ol 
these  subroutines  and  a  brief  description  of  their  use: 


Subroutine  CURS 

Sets  up  a  crosshair  cursor  pattern  for  the  I.e.xidai.i. 
Subroutine  LEXCLR  ( ILEV) 

This  program  changes  the  current  color  level  being 
written  to  by  the  plot  package 

ILEV  =  Color  level  to  be  written  to 

SiSroutine  LXBLCK 

This  subroutine  sets  the  color- 1  ook  -  up  trible  valuer 
to  zero 

auto-out  me  LXCOi.H  (ILEV,  I  COLOR) 

This  subroutine  will  change  the  Lexidata  color  look-u|) 
table  lor  a  giv^en  level 

1  ],E’v'  <  0  -  change  current  level 

=  0  -  background  /  0,  0,  0 

=  1  -  default  /15,  0,  0  red 

=  2  -  default  /  0,  15,  0  green 

=  3  -  default  /O,  10,  10  blue 

I  COLOR  =  Three  element  array  which  contains 
values  (0-15)  for  red,  green,  blue 
respec  t  i v'e  1  y 
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Subroutine  LXDEFT 


This  subroutine  restores  all  three  color  levels  to  their 
original  default  values 

Subroutine  LXLEV  (I LEV) 

This  subroutine  changes  the  Lexidata  color  level 
ILEV  =  Level  to  be  written  to 

Subroutine  TASC  AXIS  (XS , YS ,XE , YE ,NTIC ,NLAB , SVAL , STVAL . IS  IDE , I AXI S ) 


Draws  X, 
XS 
YS 
XE 
YE 

NTIC 

NLAB 

SVAL 

STVAL 

ISIDE 

lAXIS 


Y,  and  Z  axes  on  surface  plots 
=  X  -  axis  minimum  in  Lexidata  units 

=  Y  -  axis  minimum  in  Lexidata  units 

=  X  -  axis  maximum  in  Lexidata  units 

=  Y  -  axis  maximum  in  Lexidata  units 

=  Number  of  tics  along  axis 
=  Number  of  labeled  tic  marks 
=  Minimum  axis  value  in  user  units 
=  Maximum  axis  value  in  user  units 
=  Viewing  elevation  flag 
=  Flag  to  determine  axis  to  be  drawn 

=  1  X  -  axis  is  drawn 

=  2  Y  -  axis  is  drawn 

=  3  Z  -  axis  is  drawn 


Subroutine  TASC_ROTATE  (X,Y,A) 

Performs  an  in-place  transformation  of  point  (X,Y) 
thru  angle  A 

X  =  X  coordinate 
V  =  V  coordinate 
A  =  Rotation  angle  (radians) 


2.2.2  Added  Capabilities 
Subroutine  CONREC 


The  ability  to  add  headers  and  label  axes  has  been 
added  to  the  contour  plots.  The  following  common  blocks 
control  these  functions: 


COMMON  BLOCKS; 

/CRLABS/  HEADER. XTITLE.YTITLE 
/CRMXMX/  XM 1 N , XMAX , YM 1 N , YMAX , NDEC 
/CRTICS/  NXNAJ ,NXMINOR,NYMAJ,NYMlNOR 

COMMON  ARGUMENTS ; 

HEADER , XTITLE , YTITLE 

These  arguments  contain  plot  header,  X-axis,  and 
Y-axis  information  (Character  *  40) 

XH I N  ,  XMAX  ,  YM  IN  ,  YMAX 

These  arguments  contain  the  X  and  Y  minimum  and 
maximum  axis  values. 


NDEC 

This  argument  defines  the  minimum  number  of  decimal 


places  to  be  displayed 
NXMAJ , NYMAJ 

These  arguments  define 
tick  marks  along  the  X 

NXMINOR.NYMINOR 

These  arguments  define 
tick  marks  along  the  X 


on  the  X  and  Y  axis 


the 

number 

of  major 

1 abe 1 ed 

and 

Y  ax  e  s  . 

the 

number 

of  minor 

un label ed 

and 

Y  axes. 

Subroutine  SRFACE: 

The  ability  to  add  headers  and  label  axes  has  been 
to  the  surface  plots.  The  following  common  blocks 
-ontrol  these  functions: 


COMMO.X  BLOCKS; 

/SRLABS/  XTITLE , YTITLE , ZTITLE 
/SRMXMX/  XM IN, XMAX, YM IN, YMAX, NDEC 

COMMON  ARGUMENTS ; 

XTITLE , YTITLE , ZTITLE 

These  arguments  contain  X,  Y  and  Z-a.\is 
information  (Character  40) 

XM I N , XMAX , YM I N . YMAX 

These  arguments  contain  the  X  and  Y  iiiiniiiium  and 
maximum  axis  v'alues. 
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NDEC 

This  argument  defines  the  minimum  number  of  decimal 
places  to  be  displayed  on  the  X  and  Y  axis. 

ADDITIONAL  AUTOGRAPH  COMPATIBLE  ROUTINES 

This  section  is  divided  into  two  parts.  Part  1  con¬ 
tains  a  list  of  the  routines  in  TGSP  which  enhance  related 
routines  in  the  AUTOGRAPH  package  along  with  a  short  descrip¬ 
tion  of  each.  Part  2  contains  descriptions  of  the  arguments 
of  these  routines.  See  the  AUTOGRAPH  writeup  for  a  set  of 
sample  programs  using  the  package  and  the  output  produced  by 
each  of  the  programs. 

Each  of  the  following  routines  draws  a  complete  graph 
allowing  different  colors  for  each  curve  with  one  call.  Each 
is  implemented  by  a  set  of  calls  to  the  lower  level  AUTOGRAPH 
routines  AGSTUP ,  AGCURV ,  and  AGBACK. 

Part  1 


TGY ( YDRA , NPTS , GLAB , I LEV ) 

Draws  a  graph  of  the  curve  defined  by  the  data 
points  ( ( I , YDRA( I ) ) , 1 =1 , NPTS )  with  a  graph  label 
specified  by  GLAB, 

TGXY ( XDRA , YDRA , NPTS , GLAB , 1  LEV ) 

Draws  a  graph  of  the  curve  defined  by  the  data 
points  (  (XDRAd  )  ,YDRA(I))  ,1  =  1,NPTS)  with  a  graph 
label  specified  by  GLAB. 

TGMY ( YDRA , I DXY , MANY , NPTS , GLAB , I LEV ) 

Draws  a  graph  of  the  family  of  curves  defined  by 
data  points  ( ( ( I , YDRA( I , J ) ) , 1=1 ,NPTS ) , J=1 .MANY ) 
with  a  graph  label  specified  by  GLAB.  The  order  of 
the  subscripts  of  YDRA  may  be  reversed  (see  the 
routine  DISPLA,  argument  LROW). 

TGMXY ( XDRA , YDRA , IDXY , MANY , NPTS , GLAB , I  LEV ) 

Draws  a  graph  of  the  family  of  curves  defined  by  the 
data  points  ( ( (XDRA( I ) ,YDRA( I , J ) ) , 1=1 .NPTS ) , J=1 .MANY ) 
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with  a  graph  label  specified  by  GLAB .  XDRA  may  be 
doub 1 y - subsc r i pi ed  and  the  order  of  Lhe  subscripts 
ot  XDKA  and  VDK,\  may  be  reversed. 


i'.ift  1 


This  part  contains  descriptions  of  the  arguments  to 
t ne  routines:  TGV ,TGXY ,TGMY ,TGMXY .  In  calls  to  the 
routines  TGY . TGXY .TGMY  and  TGMXY 

XDRA 

.^n  array  of  .x-coordinates ,  dimensioned  as  implied 
by  the  current  value  of  the  AUTOGRAPH  control  pa¬ 
rameter  ROW.  The  V’alue  of  the  AUTOGRAPH  parameter 
NULL/1  1  .  by  de  f  au  1 1 - -when  used  as  an  x- 
coordinale,  implies  a  missing  data  point.  The 
curve  segments  on  either  side  of  such  a  (lOint  are 
not  drawn. 

i’DRA 

An  array  ol  y-coordi  nat  es  ,  d  i  iik'H:- i  oned  as  implied 
by  the  current  x’alue  of  the  H  ciaitrol  p^i- 

ramc'ter  ROW.  The  \-alue  of  t  t.e  Ai'iOOKAl’ll  p.irameier 
.NULL/ 1  .  -  -  1  .  Kb('  by  de  f  au  i  t  - -wiien  us<  as  .i  v- 
coord  i  nat  «-•  ,  implies  a  missing  d.ita  point.  ']  he 
curve  segmetits  on  either  side  ot  sucli  a  point  art- 
no  r  drawn. 

IDXY 

The  first  dimension  ol’  the  arrays  XDRA  (if  it  has 
two  dimensions)  and  YDRA. 

.MA.X'l 

I'ht  nuiiibt-r  ot  cur'/cs  to  be*  diviwn  by  the  cal  1  to 
iG.  .  .  Norma  i  iy,  t  ht-  second  dimension  of  XDRA 
(it  it  has  two  dimensions)  and  YDRA. 


the  num!)t  f  ot  (loiiits  de  fining  each  curvt-  to  tte 
drawn  t)\’  the  routine  TG .  .  .  Normally,  the  first 
(or  only)  dimension  of  XDRA  and  YDRA. 


GLAB 

A  ch.ir.ieter  string  lor  an  array  containing  a  chrir- 
a,  It-r  .string)  Ootinirig  a  label  to  lie  [i  laced  at  t  he 
'op  o!  tn.'  sgiph.  The  string  may  not  tie  more  t  h.in 
ho  a  tia  r  .H  !  ( ■  r : ,  .  It  it  is  fewer  t  h.in  oO  t'liarac  t  ers  . 
t  fio  l.i.t  snii.ietcr  must  lx-  .Y  .  (I'he  .S  is  stripped 
ott  wta-n  itia  l-di'  l  is  I'ririted.)  .A  zero  m.i\'  bo  used 
.  f:  pl.oc  Ilf  [fit  atgnmenl  GL.AB  ,  indicating,  th.it  llie 
p  r-(  'c  1  o  u  1  ,  i  I  )t  i  .s  (ii  >u  1  d  continue  to  tx-  used.  (lhe 


g  -  ti 


initial  label  consists  of  blanks.)  Note  that  the 
use  of  a  zeroed  GLAB  is  non-standard.  The  routines 
AGSETP,  AGSETF ,  and  AGSETl  may  be  used  to  define 
labels  in  a  more  nearly  standard  manner. 

ILEV 

An  integer  array,  dimensioned  MANY,  each  element 
being  an  integer  from  0  to  3  representing  the  color 
to  draw  a  curve.  The  value  ILEV(l)  determines  the 
color  of  the  first  curve,  and  ILEV(MANY)  deter¬ 
mines  the  level  of  the  last  curve.  Note: 

0  is  the  background,  usually  black 

1  is  usually  red 

2  is  usually  green 

3  is  usually  blue. 
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3. 


USER  INTERFACE 


When  the  user  wishes  to  use  to  TGSP  the  following 
link  is  required: 

LINKINTER  program_naine ,  user_library 

When  the  user  wishes  to  use  the  LINKINTER  command  file  the 
following  sequence  is  required: 

$L1NKINTER  program_name ,  user_library 

At  the  end  of  each  frame  plotted  the  user  is  offered 
the  following  options; 

•  <cr> /Clear  -  TO  CLEAR  SCREEN  AND  CONTINUE 

•  color  -  TO  CHANGE  COLORS 

•  Overlay  -  TO  CONTINUE  WITHOUT  ERASING  SCREEN 

•  Print  -  TO  PRODUCE  HARD  COPY 

•  Zoom  -  TO  ZOOM  AND  SCROLL 

•  Quit  -  TO  TERMINATE  THE  PROGRAM. 

The  routine  [ TGSP . INTER] LXPRMT . FOR  is  responsible  for  the 
prompting  sequence  seen  by  the  user  at  the  end  of  each  frame 
plotted.  If  the  user  wishes  to  modify  this  routine  the  follow¬ 
ing  command  sequence  should  be  used  once  changes  are  made  to 
LXPRMT. FOR : 

$FOR  LXPRMT 

SLINKINTER  mainname , LXPRMT , any_userl ib/1 ib 
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A. 


SUMMARY 


The  TASC  GRAPHICS  SOFTWARE  PACKAGE  was  developed  from 
the  NCAR  plot  package.  Enhancements  were  made  to  add  color 
capability,  to  make  the  package  interactive,  and  to  provide 
axes  on  surface  plots.  Attached  are  updates  to  the  NCAR  docu¬ 
mentation  reflecting  these  capabilities. 
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UPDATES 


NCAR  GRAPHICS  SOFTWARE  MANUAL 


6/30/81 


Version  1.3 


TASC  Updates 

1.  Page  31a.  Add  the  following  description  of  new  common 
areas : 

COMMON  BLOCKS; 

/CRLABS/  HEADER,  XTITLE,  YTITLE 
/CRMXMX/  XMIN,  XMAX,  YMIN,  YMAX ,  NDEC 
/CRTICS/  NXMAJ,  NXMINOR,  NYMAJ ,  NYMINOR 

COMMON  ARGUMENTS; 

HEADER,  XTITLE,  YTITLE 

These  arguments  contain  plot  header,  X-axis, 
and  Y-axis  information  (Character  *  40) 

XMIN,  XMAX,  YMIN,  YMAX 

These  arguments  contain  the  X  and  Y  minimum 
and  maximum  axis  values. 

NDEC 

This  argument  defines  the  minimum  number  of 
decimal  places  to  be  displayed  on  the  X  and 
Y  axis. 

NXMAJ,  NYMAJ 

These  arguments  define  the  number  of  major 
labeled  tick  marks  along  the  X  and  Y  axes. 

NXMINOR, NYMINOR 

These  arguments  define  the  number  of  minor 
unlabeled  tick  marks  along  the  X  and  Y  axes. 

2.  Page  33.  The  following  internal  default  values  have  be 
changed  to: 

SIZEM  1.0 
SLT  0.09 

YBT  0.09 

SIDE  0.86 


3.  Page  34.  The  following  internal  default  values  have  been 
changed  to: 

lOFFM  1 

ISOLID  1023 

A.  Page  134.  The  default  value  of  ISKIRT  is  set  to  1. 

5.  Page  134a.  Add  the  following  description  of  new  common 
areas : 

COMMON  BLOCKS; 

/SRLABS/  XTITLE,  YTITLE,  ZTITLE 
/SRMXMX/  XMIN,  XMAX,  YMIN ,  YMAX ,  NDEC 

COMMON  ARGUMENTS; 

XTITLE,  YTITLE,  ZTITLE 

These  arguments  contain  X,  Y  and  Z-axis 
information  (Character  *  40) 

XMIN,  XMAX,  YMIN,  YMAX 

These  arguments  contain  the  X  and  Y  minimum 
and  maximum  axis  values. 

NDEC 

This  argument  defines  the  minimum  number  of 
decimal  places  to  be  displayed  on  the  X  and 
Y  axis. 

6.  Page  243a.  Add  the  following  subroutine  description: 
Subroutine  CURS 

Sets  up  a  crosshair  cursor  for  the  Lexidata. 

Subroutine  LEXCLR  (ILEV) 

This  program  changes  the  current  color  level  being 
written  to  by  the  plot  package 

ILEV  =  Color  level  to  be  written  to 

Subroutine  LXBLCK 

This  subroutine  sets  the  color- look-up  table  values 
to  zero 

Subroutine  LXCOLR  (ILEV,ICOLOR) 

This  subroutine  will  change  the  Lexidata  color  look-up 
table  for  a  given  level 

ILEV  =  <0  -  Change  current  level 
=  0  -  background  /  0,0,0 

=  1  -  default  /15,0,0  red 

=  2  -  default  /0,15,0  green 

=  3  -  default  /0,10,10  blue 
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ICOLOR  =  Three  element  array  which  contains  values 
(0-15)  for  red,  green,  blue  respectively 


Subroutine  LXDEFT 

This  subroutine  restores  all  three  color  levels  to 
their  original  default  values 


Subroutine  LXLEV  (I LEV) 

This  subroutine  changes  the  Lexidata  color  level 
ILEV  =  Level  to  be  written  to 


Subroutine 

Draws 

XS 

YS 

XE 

YE 

NTIC 

NLAB 

SVAL 

STVAL 

ISIDE 

lAXIS 


T ASC_AX IS  (XS,YS,XE,YE,NTIC,N LAB , SVAL , STVAL , 
ISIDE, lAXlS) 

X,Y,  and  Z  axes  on  surface  plots 

=  X  -  axis  minimum  in  Lexidata  units 

=  Y  -  axis  minimum  in  Lexidata  units 

=  X  -  axis  maximum  in  Lexidata  units 

=  Y  -  axis  maximum  in  Lexidata  units 

Number  of  tics  along  axis 
Number  of  labeled  tick  marks 
Minimum  axis  value  in  user  units 
Maximum  axis  value  in  user  units 
Viewing  elevation  flag 
Flag  to  determine  axis 
=  1  X  -  axis  is  drawn 

=  2  Y  -  axis  is  drawn 

=  3  Z  -  axis  is  drawn 


to  be  drawn 


Subroutine  TASC_ROTATE  (X,Y,A) 

Performs  an  in-place  transformation  of  point  (X,Y) 
through  angle  A 

X  =  X  coordinate 
Y  =  Y  coordinate 
A  =  Rotation  angle  in  radians 
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